@@ -1,10 +1,13 @@ |
||
| 1 | 1 |
module Agents |
| 2 | 2 |
class PostAgent < Agent |
| 3 |
- cannot_be_scheduled! |
|
| 4 | 3 |
cannot_create_events! |
| 5 | 4 |
|
| 5 |
+ default_schedule "never" |
|
| 6 |
+ |
|
| 6 | 7 |
description <<-MD |
| 7 |
- Post Agent receives events from other agents and send those events as the contents of a post request to a specified url. `post_url` field must specify where you would like to receive post requests and do not forget to include URI scheme (`http` or `https`) |
|
| 8 |
+ A PostAgent receives events from other agents (or runs periodically), merges those events with the contents of `payload`, and sends the results as POST (or GET) requests to a specified url. |
|
| 9 |
+ |
|
| 10 |
+ The `post_url` field must specify where you would like to send requests. Please include the URI scheme (`http` or `https`). |
|
| 8 | 11 |
MD |
| 9 | 12 |
|
| 10 | 13 |
event_description "Does not produce events." |
@@ -12,7 +15,11 @@ module Agents |
||
| 12 | 15 |
def default_options |
| 13 | 16 |
{
|
| 14 | 17 |
'post_url' => "http://www.example.com", |
| 15 |
- 'expected_receive_period_in_days' => 1 |
|
| 18 |
+ 'expected_receive_period_in_days' => 1, |
|
| 19 |
+ 'method' => 'post', |
|
| 20 |
+ 'payload' => {
|
|
| 21 |
+ 'key' => 'value' |
|
| 22 |
+ } |
|
| 16 | 23 |
} |
| 17 | 24 |
end |
| 18 | 25 |
|
@@ -20,23 +27,63 @@ module Agents |
||
| 20 | 27 |
last_receive_at && last_receive_at > options['expected_receive_period_in_days'].to_i.days.ago && !recent_error_logs? |
| 21 | 28 |
end |
| 22 | 29 |
|
| 30 |
+ def method |
|
| 31 |
+ (options['method'].presence || 'post').to_s.downcase |
|
| 32 |
+ end |
|
| 33 |
+ |
|
| 23 | 34 |
def validate_options |
| 24 | 35 |
unless options['post_url'].present? && options['expected_receive_period_in_days'].present? |
| 25 | 36 |
errors.add(:base, "post_url and expected_receive_period_in_days are required fields") |
| 26 | 37 |
end |
| 27 |
- end |
|
| 28 | 38 |
|
| 29 |
- def post_event(uri, event) |
|
| 30 |
- req = Net::HTTP::Post.new(uri.request_uri) |
|
| 31 |
- req.form_data = event |
|
| 32 |
- Net::HTTP.start(uri.hostname, uri.port, :use_ssl => uri.scheme == "https") { |http| http.request(req) }
|
|
| 39 |
+ if options['payload'].present? && !options['payload'].is_a?(Hash) |
|
| 40 |
+ errors.add(:base, "if provided, payload must be a hash") |
|
| 41 |
+ end |
|
| 42 |
+ |
|
| 43 |
+ unless %w[post get].include?(method) |
|
| 44 |
+ errors.add(:base, "method must be 'post' or 'get'") |
|
| 45 |
+ end |
|
| 33 | 46 |
end |
| 34 | 47 |
|
| 35 | 48 |
def receive(incoming_events) |
| 36 | 49 |
incoming_events.each do |event| |
| 37 |
- uri = URI options[:post_url] |
|
| 38 |
- post_event uri, event.payload |
|
| 50 |
+ handle (options['payload'].presence || {}).merge(event.payload)
|
|
| 39 | 51 |
end |
| 40 | 52 |
end |
| 53 |
+ |
|
| 54 |
+ def check |
|
| 55 |
+ handle options['payload'].presence || {}
|
|
| 56 |
+ end |
|
| 57 |
+ |
|
| 58 |
+ def generate_uri(params = nil) |
|
| 59 |
+ uri = URI options[:post_url] |
|
| 60 |
+ uri.query = URI.encode_www_form(Hash[URI.decode_www_form(uri.query || '')].merge(params)) if params |
|
| 61 |
+ uri |
|
| 62 |
+ end |
|
| 63 |
+ |
|
| 64 |
+ private |
|
| 65 |
+ |
|
| 66 |
+ def handle(data) |
|
| 67 |
+ if method == 'post' |
|
| 68 |
+ post_data(data) |
|
| 69 |
+ elsif method == 'get' |
|
| 70 |
+ get_data(data) |
|
| 71 |
+ else |
|
| 72 |
+ error "Invalid method '#{method}'"
|
|
| 73 |
+ end |
|
| 74 |
+ end |
|
| 75 |
+ |
|
| 76 |
+ def post_data(data) |
|
| 77 |
+ uri = generate_uri |
|
| 78 |
+ req = Net::HTTP::Post.new(uri.request_uri) |
|
| 79 |
+ req.form_data = data |
|
| 80 |
+ Net::HTTP.start(uri.hostname, uri.port, :use_ssl => uri.scheme == "https") { |http| http.request(req) }
|
|
| 81 |
+ end |
|
| 82 |
+ |
|
| 83 |
+ def get_data(data) |
|
| 84 |
+ uri = generate_uri(data) |
|
| 85 |
+ req = Net::HTTP::Get.new(uri.request_uri) |
|
| 86 |
+ Net::HTTP.start(uri.hostname, uri.port, :use_ssl => uri.scheme == "https") { |http| http.request(req) }
|
|
| 87 |
+ end |
|
| 41 | 88 |
end |
| 42 | 89 |
end |
@@ -5,8 +5,11 @@ describe Agents::PostAgent do |
||
| 5 | 5 |
@valid_params = {
|
| 6 | 6 |
:name => "somename", |
| 7 | 7 |
:options => {
|
| 8 |
- :post_url => "http://www.example.com", |
|
| 9 |
- :expected_receive_period_in_days => 1 |
|
| 8 |
+ 'post_url' => "http://www.example.com", |
|
| 9 |
+ 'expected_receive_period_in_days' => 1, |
|
| 10 |
+ 'payload' => {
|
|
| 11 |
+ 'default' => 'value' |
|
| 12 |
+ } |
|
| 10 | 13 |
} |
| 11 | 14 |
} |
| 12 | 15 |
|
@@ -17,28 +20,69 @@ describe Agents::PostAgent do |
||
| 17 | 20 |
@event = Event.new |
| 18 | 21 |
@event.agent = agents(:jane_weather_agent) |
| 19 | 22 |
@event.payload = {
|
| 20 |
- :somekey => "somevalue", |
|
| 21 |
- :someotherkey => {
|
|
| 22 |
- :somekey => "value" |
|
| 23 |
+ 'somekey' => 'somevalue', |
|
| 24 |
+ 'someotherkey' => {
|
|
| 25 |
+ 'somekey' => 'value' |
|
| 23 | 26 |
} |
| 24 | 27 |
} |
| 25 | 28 |
|
| 26 |
- @sent_messages = [] |
|
| 27 |
- stub.any_instance_of(Agents::PostAgent).post_event { |uri, event| @sent_messages << event }
|
|
| 29 |
+ @sent_posts = [] |
|
| 30 |
+ @sent_gets = [] |
|
| 31 |
+ stub.any_instance_of(Agents::PostAgent).post_data { |data| @sent_posts << data }
|
|
| 32 |
+ stub.any_instance_of(Agents::PostAgent).get_data { |data| @sent_gets << data }
|
|
| 28 | 33 |
end |
| 29 | 34 |
|
| 30 | 35 |
describe "#receive" do |
| 31 |
- it "checks if it can handle multiple events" do |
|
| 36 |
+ it "can handle multiple events and merge the payloads with options['payload']" do |
|
| 32 | 37 |
event1 = Event.new |
| 33 | 38 |
event1.agent = agents(:bob_weather_agent) |
| 34 | 39 |
event1.payload = {
|
| 35 |
- :xyz => "value1", |
|
| 36 |
- :message => "value2" |
|
| 40 |
+ 'xyz' => 'value1', |
|
| 41 |
+ 'message' => 'value2', |
|
| 42 |
+ 'default' => 'value2' |
|
| 37 | 43 |
} |
| 38 | 44 |
|
| 39 | 45 |
lambda {
|
| 40 |
- @checker.receive([@event, event1]) |
|
| 41 |
- }.should change { @sent_messages.length }.by(2)
|
|
| 46 |
+ lambda {
|
|
| 47 |
+ @checker.receive([@event, event1]) |
|
| 48 |
+ }.should change { @sent_posts.length }.by(2)
|
|
| 49 |
+ }.should_not change { @sent_gets.length }
|
|
| 50 |
+ |
|
| 51 |
+ @sent_posts[0].should == @event.payload.merge('default' => 'value')
|
|
| 52 |
+ @sent_posts[1].should == event1.payload |
|
| 53 |
+ end |
|
| 54 |
+ |
|
| 55 |
+ it "can make GET requests" do |
|
| 56 |
+ @checker.options['method'] = 'get' |
|
| 57 |
+ |
|
| 58 |
+ lambda {
|
|
| 59 |
+ lambda {
|
|
| 60 |
+ @checker.receive([@event]) |
|
| 61 |
+ }.should change { @sent_gets.length }.by(1)
|
|
| 62 |
+ }.should_not change { @sent_posts.length }
|
|
| 63 |
+ |
|
| 64 |
+ @sent_gets[0].should == @event.payload.merge('default' => 'value')
|
|
| 65 |
+ end |
|
| 66 |
+ end |
|
| 67 |
+ |
|
| 68 |
+ describe "#check" do |
|
| 69 |
+ it "sends options['payload'] as a POST request" do |
|
| 70 |
+ lambda {
|
|
| 71 |
+ @checker.check |
|
| 72 |
+ }.should change { @sent_posts.length }.by(1)
|
|
| 73 |
+ |
|
| 74 |
+ @sent_posts[0].should == @checker.options['payload'] |
|
| 75 |
+ end |
|
| 76 |
+ |
|
| 77 |
+ it "sends options['payload'] as a GET request" do |
|
| 78 |
+ @checker.options['method'] = 'get' |
|
| 79 |
+ lambda {
|
|
| 80 |
+ lambda {
|
|
| 81 |
+ @checker.check |
|
| 82 |
+ }.should change { @sent_gets.length }.by(1)
|
|
| 83 |
+ }.should_not change { @sent_posts.length }
|
|
| 84 |
+ |
|
| 85 |
+ @sent_gets[0].should == @checker.options['payload'] |
|
| 42 | 86 |
end |
| 43 | 87 |
end |
| 44 | 88 |
|
@@ -59,13 +103,65 @@ describe Agents::PostAgent do |
||
| 59 | 103 |
end |
| 60 | 104 |
|
| 61 | 105 |
it "should validate presence of post_url" do |
| 62 |
- @checker.options[:post_url] = "" |
|
| 106 |
+ @checker.options['post_url'] = "" |
|
| 63 | 107 |
@checker.should_not be_valid |
| 64 | 108 |
end |
| 65 | 109 |
|
| 66 | 110 |
it "should validate presence of expected_receive_period_in_days" do |
| 67 |
- @checker.options[:expected_receive_period_in_days] = "" |
|
| 111 |
+ @checker.options['expected_receive_period_in_days'] = "" |
|
| 112 |
+ @checker.should_not be_valid |
|
| 113 |
+ end |
|
| 114 |
+ |
|
| 115 |
+ it "should validate method as post or get, defaulting to post" do |
|
| 116 |
+ @checker.options['method'] = "" |
|
| 117 |
+ @checker.method.should == "post" |
|
| 118 |
+ @checker.should be_valid |
|
| 119 |
+ |
|
| 120 |
+ @checker.options['method'] = "POST" |
|
| 121 |
+ @checker.method.should == "post" |
|
| 122 |
+ @checker.should be_valid |
|
| 123 |
+ |
|
| 124 |
+ @checker.options['method'] = "get" |
|
| 125 |
+ @checker.method.should == "get" |
|
| 126 |
+ @checker.should be_valid |
|
| 127 |
+ |
|
| 128 |
+ @checker.options['method'] = "wut" |
|
| 129 |
+ @checker.method.should == "wut" |
|
| 130 |
+ @checker.should_not be_valid |
|
| 131 |
+ end |
|
| 132 |
+ |
|
| 133 |
+ it "should validate payload as a hash, if present" do |
|
| 134 |
+ @checker.options['payload'] = "" |
|
| 135 |
+ @checker.should be_valid |
|
| 136 |
+ |
|
| 137 |
+ @checker.options['payload'] = "hello" |
|
| 138 |
+ @checker.should_not be_valid |
|
| 139 |
+ |
|
| 140 |
+ @checker.options['payload'] = ["foo", "bar"] |
|
| 68 | 141 |
@checker.should_not be_valid |
| 142 |
+ |
|
| 143 |
+ @checker.options['payload'] = { 'this' => 'that' }
|
|
| 144 |
+ @checker.should be_valid |
|
| 145 |
+ end |
|
| 146 |
+ end |
|
| 147 |
+ |
|
| 148 |
+ describe "#generate_uri" do |
|
| 149 |
+ it "merges params with any in the post_url" do |
|
| 150 |
+ @checker.options['post_url'] = "http://example.com/a/path?existing_param=existing_value" |
|
| 151 |
+ uri = @checker.generate_uri("some_param" => "some_value", "another_param" => "another_value")
|
|
| 152 |
+ uri.request_uri.should == "/a/path?existing_param=existing_value&some_param=some_value&another_param=another_value" |
|
| 153 |
+ end |
|
| 154 |
+ |
|
| 155 |
+ it "works fine with urls that do not have a query" do |
|
| 156 |
+ @checker.options['post_url'] = "http://example.com/a/path" |
|
| 157 |
+ uri = @checker.generate_uri("some_param" => "some_value", "another_param" => "another_value")
|
|
| 158 |
+ uri.request_uri.should == "/a/path?some_param=some_value&another_param=another_value" |
|
| 159 |
+ end |
|
| 160 |
+ |
|
| 161 |
+ it "just returns the post_uri when no params are given" do |
|
| 162 |
+ @checker.options['post_url'] = "http://example.com/a/path?existing_param=existing_value" |
|
| 163 |
+ uri = @checker.generate_uri |
|
| 164 |
+ uri.request_uri.should == "/a/path?existing_param=existing_value" |
|
| 69 | 165 |
end |
| 70 | 166 |
end |
| 71 | 167 |
end |